home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / satellit / orbits / passupdt / passupdt.doc < prev    next >
Text File  |  1992-09-14  |  9KB  |  166 lines
  1.                               Documentation for
  2.                                  Pass Update
  3.  
  4.                                  Developed by
  5.                                  Dr TS Kelso
  6.  
  7.                                  Version 2.50
  8.                               1992 September 13
  9.  
  10.                         Copyright (C) 1989, 1990, 1992
  11.                              All rights reserved
  12.  
  13.  
  14. Pass Update is a program which will allow the you to automatically update
  15. groups of two-line element sets.  This program supports the maintenance of
  16. user-defined special groups of satellites for easy use in other packages and
  17. allows you to update any or all of these files at one time.  For example, you
  18. may want to maintain separate .TLE (two-line element) files on groups of
  19. weather satellites (e.g., NOAA.TLE, METEOR.TLE) or amateur radio (e.g.,
  20. AMATEUR.TLE).
  21.  
  22. The program PASSUPDT.EXE (Two-Line Element Set Update) can be run stand-alone
  23. or from within Pass Scheduler.  After an initial information screen, PASSUPDT
  24. will present a screen listing up to 49 .TLE files which you can select to
  25. update.
  26.  
  27. Files are selected for update by positioning the highlight on the file to be
  28. selected (using the cursor keys, Home to move to the first file, or End to
  29. move to the last file) and toggling with the space bar.  All files may be
  30. selected using the 'A' key (which actually toggles the selection status of all
  31. files).  All files can be deselected by pressing the 'U' key.
  32.  
  33. Once the files to be updated are selected, press <ENTER> to begin the update
  34. process.  PASSUPDT will go through each file selected, showing its status as
  35. it goes.  You can abort this process (after the current file is processed) by
  36. pressing the <ESC> key at any time.
  37.  
  38. During the update process, the program will show the two-line elements for
  39. each satellite in the file to be updated.  The color of the elements indicates
  40. their age.  Elements 0 to 15 days old are green, 16 to 30 days old are yellow,
  41. 31 to 45 days are red, and anything over 45 days is brown (on the rare
  42. occasion where elements are released before the current date, these show up as
  43. blue).
  44.  
  45. If a matching element set is found in the update database, it is shown using
  46. the same color scheme.  If the element sets are identical or the update data
  47. is older, no change is made.  If the update data is newer, an update is
  48. performed.  Since the program checks both the epoch date and the element set
  49. number, you will be prompted if the two do not agree (e.g., when the
  50. element set number wraps around from 999 to 000).  No update will be performed
  51. if the new element set does not pass the modulo-10 checksum or does not
  52. conform to the standard two-line format.
  53.  
  54. If no update is available or the data is older than 30 days, you will be
  55. prompted to determine whether that element set should be deleted.
  56.  
  57. After all the selected files have been updated, PASSUPDT will check for the
  58. existence of the file PASSUPDT.CAT containing a list of NORAD Catalog Numbers
  59. (in increasing numerical order, each number having leading zeros, if
  60. necessary).  If this file exists, PASSUPDT will check for the existence of
  61. files of the form SATcatnr.Dyy (in the default data directory), where catnr is
  62. the NORAD Catalog Number and yy is the epoch year of the two-line element
  63. set(s).  PASSUPDT will add new element sets to existing files or create new
  64. files, as appropriate.  This option makes it easy to maintain catalogs of
  65. element sets for programs which require them.  An example of such a program is
  66. one which registers satellite imagery to a geodetic grid; each image to be
  67. registered requires the two-line data closest to the time of the image, not
  68. the most recent data.
  69.  
  70.  
  71. OPTIONS
  72.  
  73. Many users prefer to be able to allow PASSUPDT to run without being prompted
  74. for old data, epoch/elset discrepancies, and missing data.  While this mode of
  75. operation is not recommended, the user has the option of configuring PASSUPDT
  76. to process without prompting through the configuration file PASSUPDT.CFG.  A
  77. sample configuration file is shown below.
  78.  
  79. Sample PASSUPDT.CFG file
  80. ==============================================================================
  81.                                   % Default data drive
  82. \SAT\DATA\                        % Default data directory
  83. C:\COMM\TLE.TXT                   % Default update database
  84. 100                               % Program delay (milliseconds)
  85. Y                                 % Ask to update data
  86. Y                                 % Ask to delete old data
  87. Y                                 % Ask to delete missing data
  88. 3                                 % Lines per record (2 or 3)
  89. ==============================================================================
  90.  
  91. This file MUST be present to run; the program will present an error message
  92. stating that PASSUPDT.CFG is missing and abort if it cannot find the file in
  93. the working directory.
  94.  
  95. The first two lines of this file are used to specify the default drive and
  96. directory containing the .TLE files to be updated.  If either line is blank,
  97. the current drive and/or directory is assumed (the sample above assumes the
  98. .TLE files are to be found on the active drive in the subdirectory \SAT\DATA).
  99. If no .TLE files are found, an error message to that effect will be printed
  100. and the program will abort.
  101.  
  102. The next line specifies the drive, path, and filename of the master update
  103. file to be used.  For example, if you download the file TLE.TXT into the \COMM
  104. directory on your C: drive (you can get a current copy of TLE.TXT from the
  105. Celestial BBS listed at end of this document), you can run PASSUPDT using this
  106. new data without moving or otherwise manipulating the file.  In fact, PASSUPDT
  107. will search the file for the first line beginning with '1 ' to find where the
  108. data starts, for those of you who receive the data with some kind of header
  109. attached.  Once again, if this file cannot be found, an error message is
  110. reported and the program will abort.
  111.  
  112. The next line sets the pause (in milliseconds) after each element set update
  113. before continuing the program.  The primary purpose for this delay is to allow
  114. the user to become more familiar with the update process by slowing the
  115. program down enough to watch.  If you are not interested in watching, you can
  116. set this value to some small positive number.
  117.  
  118. The next three lines are used to specify whether you want to be asked to
  119. update data when there is a discrepancy between element sets (e.g., newer
  120. epoch but older element set number) or to delete when the data is over 30 days
  121. old or no new data is available.  If you answer No to these questions,
  122. PASSUPDT will do the safe thing, that is, it will NOT update questionable
  123. data and it will NOT delete old or missing data.  If you choose to disable
  124. these prompts, it will be left to you to decide how you want to resolve any
  125. discrepancies which occur in your databases.
  126.  
  127. The final line in PASSUPDT.CFG is used to indicate whether the master update
  128. file contains only two-line element sets or contains a name followed by a two-
  129. line element set.  If only two-line data is used, a 2 should be entered; files
  130. including satellite names (such as TLE.TXT) should have a 3.  Any other value
  131. will result in a 3 being assumed.
  132.  
  133.  
  134. CONCLUSION
  135.  
  136. That should about do it.  This code has been thoroughly tested and validated
  137. to ensure it works (this new version has been used since May 1992 for my daily
  138. updates) and you should have no problems with it.  I believe that this version
  139. corrects many of the difficulties and potential pitfalls of Version 1.00 and
  140. hope you will find it useful.  However, if you note any difficulties or would
  141. like to make suggestions as to future features, please feel free to do so.
  142. Simply leave me a message on the Celestial BBS or via Internet.  In a
  143. continuing effort to promote standardization of orbital calculations, I will
  144. endeavor to continue to improve this package and will gratefully accept user
  145. feedback or contributions to this effort.
  146.  
  147. NOTE:  The previous release of this program was packaged with the Pass
  148.        Scheduler -- that program will be updated soon and released separately.
  149.        This program should, however, still run with the original version of
  150.        PASSCHED.
  151.  
  152.                                        - Dr TS Kelso
  153.                                          Internet:  tkelso@afit.af.mil
  154.                                          anonymous ftp at archive.afit.af.mil
  155.                                            in the directory pub/space
  156.  
  157.                                          SYSOP, Celestial BBS
  158.                                          513/427-0674 (modem)
  159.                                          Operating 24 hours/day
  160.                                          No parity, 8 data bits, 1 stop bit
  161.                                          300, 1200, 2400, 4800, and 9600 bps
  162.                                          v.32/32bis, v.42/42bis
  163.  
  164.                                          2340 Raider Drive
  165.                                          Fairborn, OH, USA  45324-2001
  166.